home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / ALgetfloatmax.z / ALgetfloatmax
Encoding:
Text File  |  1998-10-20  |  7.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm))))                                          AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ALgetfloatmax, ALsetfloatmax - (obsolete) get/set the maximum value of
  10.      floating point sample data.
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  14.  
  15.      ddddoooouuuubbbblllleeee AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg))))
  16.      iiiinnnntttt AAAALLLLsssseeeettttffffllllooooaaaattttmmmmaaaaxxxx((((AAAALLLLccccoooonnnnffffiiiigggg ccccoooonnnnffffiiiigggg,,,, ddddoooouuuubbbblllleeee mmmmaaaaxxxxiiiimmmmuuuummmm____vvvvaaaalllluuuueeee))))
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  19.      _c_o_n_f_i_g          expects an AAAALLLLccccoooonnnnffffiiiigggg structure, the returned value of a
  20.                      call to AAAALLLLnnnneeeewwwwccccoooonnnnffffiiiigggg((((3333ddddmmmm)))) or AAAALLLLggggeeeettttccccoooonnnnffffiiiigggg((((3333ddddmmmm)))).
  21.  
  22.      _m_a_x_i_m_u_m__v_a_l_u_e   expects an IEEE double precision floating point value
  23.                      which defines the range of the floating point data for
  24.                      the AAAALLLLrrrreeeeaaaaddddssssaaaammmmppppssss((((3333ddddmmmm)))) or AAAALLLLwwwwrrrriiiitttteeeessssaaaammmmppppssss((((3333ddddmmmm)))) functions.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      AAAALLLLsssseeeettttffffllllooooaaaattttmmmmaaaaxxxx and AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx are obsolete and provided for backward
  28.      compatibility. The preferred functions are aaaallllSSSSeeeettttFFFFllllooooaaaattttMMMMaaaaxxxx((((3333ddddmmmm)))) and
  29.      aaaallllGGGGeeeettttFFFFllllooooaaaattttMMMMaaaaxxxx((((3333ddddmmmm)))).
  30.  
  31.      AAAALLLLsssseeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) simultaneously sets the upper and lower bounds of the
  32.      data read from a port with the AAAALLLLrrrreeeeaaaaddddssssaaaammmmppppssss((((3333ddddmmmm)))) function or written with
  33.      the AAAALLLLwwwwrrrriiiitttteeeessssaaaammmmppppssss((((3333ddddmmmm)))) function.
  34.  
  35.      The data transferred into a program with AAAALLLLrrrreeeeaaaaddddssssaaaammmmppppssss((((3333ddddmmmm)))) will be scaled
  36.      to the range (-_m_a_x_i_m_u_m__v_a_l_u_e, _m_a_x_i_m_u_m__v_a_l_u_e), where the maximum value of
  37.      the input data (32767 in the case of 16-bit analog input) will correspond
  38.      to _m_a_x_i_m_u_m__v_a_l_u_e.  Likewise, the value -32768 will correspond to
  39.      -_m_a_x_i_m_u_m__v_a_l_u_e in this case.
  40.  
  41.      Data output with AAAALLLLwwwwrrrriiiitttteeeessssaaaammmmppppssss((((3333ddddmmmm)))) should fall in the range (-
  42.      _m_a_x_i_m_u_m__v_a_l_u_e, _m_a_x_i_m_u_m__v_a_l_u_e) to avoid limiting.
  43.  
  44.      AAAALLLLsssseeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) is only meaningful when the sample format for _c_o_n_f_i_g
  45.      is set to AAAALLLL____SSSSAAAAMMMMPPPPFFFFMMMMTTTT____FFFFLLLLOOOOAAAATTTT or AAAALLLL____SSSSAAAAMMMMPPPPFFFFMMMMTTTT____DDDDOOOOUUUUBBBBLLLLEEEE.  See AAAALLLLsssseeeettttssssaaaammmmppppffffmmmmtttt((((3333ddddmmmm))))
  46.      for more details regarding setting the sample data format.
  47.  
  48.      AAAALLLLsssseeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) can fail for the following reasons:
  49.  
  50.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG     _c_o_n_f_i_g is invalid or null.
  51.  
  52.      AAAALLLL____BBBBAAAADDDD____FFFFLLLLOOOOAAAATTTTMMMMAAAAXXXX   _m_a_x_i_m_u_m__v_a_l_u_e is zero.
  53.  
  54.      AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) returns the current double precision value of the
  55.      bounds in AAAALLLLccccoooonnnnffffiiiigggg structure _c_o_n_f_i_g.
  56.  
  57.      AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) can fail for the following reason:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm))))                                          AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      AAAALLLL____BBBBAAAADDDD____CCCCOOOONNNNFFFFIIIIGGGG   _c_o_n_f_i_g is invalid or null.
  75.  
  76. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  77.      Upon successful completion, AAAALLLLsssseeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) returns 0. Otherwise,
  78.      AAAALLLLsssseeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) returns -1 and sets an error number which can be
  79.      retrieved with oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  80.  
  81.      AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) returns 0 in the case of failure and sets an error
  82.      number which can be retrieved with oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))). When successful,
  83.      AAAALLLLggggeeeettttffffllllooooaaaattttmmmmaaaaxxxx((((3333ddddmmmm)))) returns a non-zero value.
  84.  
  85. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.      ALnewconfig(3dm), ALgetconfig(3dm), ALopenport(3dm), ALsetconfig(3dm),
  87.      ALsetsampfmt(3dm), oserror(3C)
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.